| 微信公众号 | 您所在的位置：网站首页 › 微信公众号 订阅 › 微信公众号 |
|
四、订阅通知
设置订阅功能：服务号可以在图文消息、网页等场景设置订阅功能。下发条件：用户在前述场景主动订阅后，服务号可通过接口向用户发送订阅通知，如信用卡动账提醒、物流到货通知等。下发位置：对已关注服务号的用户，通知下发到号内，未关注的下发到服务通知。跳转能力：可以跳转到公众号图文消息、网页和小程序。通知类型：分为一次性订阅和长期订阅——
一次性订阅，指用户订阅一次，服务号可不限时间地下发一条对应的订阅通知；长期订阅，指用户订阅一次，服务号可长期多次下发通知，长期订阅通知仅向政务民生、医疗等公共服务领域开放。
1.addTemplate选用模板
请求地址 POST https://api.weixin.qq.com/wxaapi/newtmpl/addtemplate?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明access_tokenstring 是接口调用凭证tidstring 是模板标题 id，可通过getPubTemplateTitleList接口获取，也可登录公众号后台查看获取kidListArray. 是开发者自行组合好的模板关键词列表，关键词顺序可以自由搭配（例如 [3,5,4] 或 [4,5,3]），最多支持5个，最少2个关键词组合sceneDescstring 是服务场景描述，15个字以内返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息priTmplIdstring添加至帐号下的模板id，发送订阅通知时所需 2.deleteTemplate删除模板请求地址 POST https://api.weixin.qq.com/wxaapi/newtmpl/deltemplate?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明access_tokenstring 是接口调用凭证priTmplIdstring 是要删除的模板id返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息 3.getCategory获取公众号类目请求地址 GET https://api.weixin.qq.com/wxaapi/newtmpl/getcategory?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明access_tokenstring 是接口调用凭证返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息dataArray.类目列表data 的结构 属性类型说明idnumber类目id，查询公共模板库时需要namestring类目的中文名 4.getPubTemplateKeyWordsById获取模板中的关键词请求地址 GET https://api.weixin.qq.com/wxaapi/newtmpl/getpubtemplatekeywords?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明access_tokenstring 是接口调用凭证tidstring 是模板标题 id，可通过接口获取返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息countnumber公共模板列表总数dataArray.关键词列表data 的结构 属性类型说明kidnumber关键词 id，选用模板时需要namestring关键词内容examplestring关键词内容对应的示例rulestring参数类型 5.getPubTemplateTitleList获取类目下的公共模板请求地址 GET https://api.weixin.qq.com/wxaapi/newtmpl/getpubtemplatetitles?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明idsstring 是类目 id，多个用逗号隔开startnumber 是用于分页，表示从 start 开始，从 0 开始计数limitnumber 是用于分页，表示拉取 limit 条记录，最大为 30返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息countnumber公共模板列表总数dataArray.模板标题列表data 的结构 属性类型说明tidnumber模版标题 idtitlestring模版标题typenumber模版类型，2 为一次性订阅，3 为长期订阅categoryIdnumber模版所属类目 id 6.getTemplateList获取私有模板列表请求地址 GET https://api.weixin.qq.com/wxaapi/newtmpl/gettemplate?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明access_tokenstring 是接口调用凭证返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息dataArray.个人模板列表data 的结构 属性类型说明priTmplIdstring添加至帐号下的模板 id，发送订阅通知时所需titlestring模版标题contentstring模版内容examplestring模板内容示例typenumber模版类型，2 为一次性订阅，3 为长期订阅 7.send发送订阅通知请求地址 POST https://api.weixin.qq.com/cgi-bin/message/subscribe/bizsend?access_token=ACCESS_TOKEN 请求参数 属性类型默认值必填说明access_tokenstring 是接口调用凭证touserstring 是接收者（用户）的 openidtemplate_idstring 是所需下发的订阅模板idpagestring 否跳转网页时填写miniprogramArray. 否跳转小程序时填写，格式如{ "appid": "pagepath": { "value": any } }dataObject 是模板内容，格式形如 { "key1": { "value": any }, "key2": { "value": any } }page 和 miniprogram 同时不填，无跳转；page 和 miniprogram 同时填写，优先跳转小程序； 返回值 Object 返回的 JSON 数据包 属性类型说明errcodenumber错误码errmsgstring错误信息订阅通知参数值内容限制说明 参数类别参数说明参数值限制说明thing.DATA事物20个以内字符可汉字、数字、字母或符号组合number.DATA数字32位以内数字只能数字，可带小数letter.DATA字母32位以内字母只能字母symbol.DATA符号5位以内符号只能符号character_string.DATA字符串32位以内数字、字母或符号可数字、字母或符号组合time.DATA时间24小时制时间格式（支持+年月日），支持填时间段，两个时间点之间用“~”符号连接例如：15:01，或：2019年10月1日 15:01date.DATA日期年月日格式（支持+24小时制时间），支持填时间段，两个时间点之间用“~”符号连接例如：2019年10月1日，或：2019年10月1日 15:01amount.DATA金额1个币种符号+10位以内纯数字，可带小数，结尾可带“元”可带小数phone_number.DATA电话17位以内，数字、符号电话号码，例：+86-0766-66888866car_number.DATA车牌8位以内，第一位与最后一位可为汉字，其余为字母或数字车牌号码：粤A8Z888挂name.DATA姓名10个以内纯汉字或20个以内纯字母或符号中文名10个汉字内；纯英文名20个字母内；中文和字母混合按中文名算，10个字内phrase.DATA汉字5个以内汉字5个以内纯汉字，例如：配送中 8.事件推送用户操作订阅通知弹窗 场景：用户在图文等场景内订阅通知的操作 参数描述ToUserName公众号微信号FromUserName用户 openidCreateTime时间戳TemplateId模板 id（一次订阅可能有多条通知，带有多个 id）SubscribeStatusString用户点击行为（同意、取消发送通知）PopupScene场景SubscribeStatusString 的合法值 值说明accept用户点击“同意”reject用户点击“取消”PopupScene 的合法值 值说明1弹窗来自 H5 页面2弹窗来自图文消息XML 示例 1610969440 2 2用户管理订阅通知 场景：用户在服务通知管理页面做通知管理时的操作 参数描述ToUserName公众号微信号FromUserName用户 openidCreateTime时间戳TemplateId模板 id（一次订阅可能有多条通知，带有多个 id）SubscribeStatusString用户点击行为（仅推送用户拒收通知）SubscribeStatusString 的合法值 值说明reject用户点击“取消”XML 示例 1610969440发送订阅通知 场景：调用 bizsend 接口发送通知 参数描述ToUserName公众号微信号FromUserName用户 openidCreateTime时间戳TemplateId模板 id（一次订阅可能有多条通知，带有多个 id）MsgID消息 idErrorCode推送结果状态码（0表示成功）ErrorStatus推送结果状态码文字含义*失败仅包含因异步推送导致的系统失败 XML 示例 1610969468 1700827132819554304 0
|
| CopyRight 2018-2019 实验室设备网 版权所有 |